🤖 I have created a release beep boop

5.0.0 (2026-01-25)

⚠ BREAKING CHANGES

• compose: implement compose v2 with improved typing (#426)
• core: add support for tc.host and de-prioritise docker:dind (#388)

Features

• Add ExecWaitStrategy and migrate Postgres from deprecated decorator (#935) (2d9eee3)
• Add SocatContainer (#795) (2f9139c)
• Adding support for Cassandra and Scylla (#167) (2d8bc11)
• azurite: Enhance connection string generation for network and local access (#859) (b21e5e3)
• build: use poetry and organise modules (#408) (6c69583)
• client: Add custom User-Agent in Docker client as tc-python/<version> (#507) (dd55082)
• compose: ability to retain volumes when using context manager (#659) (e1e3d13)
• compose: add ability to get docker compose config (#669) (8c28a86)
• compose: allow running specific services in compose (f61dcda)
• compose: implement compose v2 with improved typing (#426) (5356caf)
• compose: support for setting profiles (#738) (3e00e71)
• core: add ability to do OR & AND for waitforlogs (#661) (b1453e8)
• core: add enhanced wait strategies (#855) (60d21f8)
• core: add support for tc.host and de-prioritise docker:dind (#388) (2db8e6d)
• core: Add support for ollama module (#618) (5442d05)
• core: Added Generic module (#612) (e575b28)
• core: Added ServerContainer (#595) (0768490)
• core: allow custom dockerfile path for image build and bypassing build cache (#615) (ead0f79), closes #610
• core: DockerCompose: support list of env_files (#847) (fe206eb)
• core: DockerCompose.stop now stops only services that it starts (does not stop the other services) (#620) (e711800)
• core: Image build (Dockerfile support) (#585) (54c88cf)
• core: Private registry (#566) (59fbcfa)
• core: Protocol support for container port bind and expose (#690) (a0d4317)
• core: Support working with env files (#737) (932ee30)
• DockerContainer initializer to accept its private members as kwargs (#809) (e7feb53)
• labels: Add common testcontainers labels (#519) (e04b7ac)
• main: New Testcontainers Python Docs Site (#822) (a6bdf0e)
• make config monkeypatchable, fix config related startup issues (#833) (ff6a32d)
• modules: add OpenFGA module (#762) (0b7b482)
• network: Add network context manager (#367) (11964de)
• new: Added AWS Lambda module (#655) (9161cb6)
• postgres: Remove SqlAlchemy dependency from postgres container (#445) (f30eb1d)
• redis: support AsyncRedisContainer (#442) (cc4cb37)
• refactor network setup (#678) (d5de0aa)
• release: automate release via release-please (#429) (30f859e)
• reliability: integrate the ryuk container for better container cleanup (#314) (d019874)
• set multiple variables via keyword args (#804) (1532df5)
• support influxdb (#413) (13742a5)

Bug Fixes

• Add CassandraContainer (#476) (507e466)
• add chroma container (#515) (0729bf4)
• Add Cockroach DB Module to Testcontainers (#608) (4aff679)
• Add container Trino (#642) (49ce5a5), closes #641
• Add Db2 support (#673) (1e43923)
• Add memcached container (#322) (690b9b4)
• add ruff to deps (#919) (5853d32)
• Add selenium video support #6 (#364) (3c8006c)
• Add Weaviate module (#492) (90762e8)
• added types to exec & tc_properties_get_tc_host (#561) (9eabb79)
• Added URLError to exceptions to wait for in elasticsearch (0f9ad24)
• Allow passing in a custom wait strategy string in MySQL, Cassandra, Kafka and Trino (#953) (be4d09e)
• allow running all tests (#721) (f958cf9)
• arangodb: tests to pass on ARM CPUs - change default image to 3.11.x where ARM image is published (#479) (7b58a50)
• assert-in-get_container_host_ip-before-start (#862) (fc4155e)
• bring back cassandra driver bc otherwise how does it get installed for cassandra module test run? (#680) (71c3a1a)
• build: add pre-commit as a dev dependency to simplify local dev and CI (#438) (1223583)
• build: early exit strategy for modules (#437) (7358b49)
• cassandra,mysqk,kafka: Use wait strategy instead of deprecated wait_for_logs (#945) (b7791b9)
• cassandra: make cassandra dependency optional/test-only (#518) (bddbaeb)
• Change env var disabling OpenSearch security plugin (#773) (2620d7f)
• changed files breaks on main (#422) (3271357)
• changelog after release-please (#469) (dcb4f68)
• clickhouse: clickhouse waiting (#428) (902a5a3)
• Close docker client when stopping the docker container (#380) (efb1683)
• compose: expose useful compose options (#951) (183e1aa)
• compose: use provided docker command instead of default (#785) (0ae704a)
• configuration: strip whitespaces when reading .testcontainers.properties (#474) (ade144e)
• Container for Milvus database (#606) (ec76df2)
• core: #486 for colima delay for port avail for connect (#543) (90bb780)
• core: add empty _configure to DockerContainer (#556) (08916c8)
• core: Add kwargs to image build (#708) (cc02f94)
• core: add TESTCONTAINERS_HOST_OVERRIDE as alternative to TC_HOST (#384) (8073874)
• core: Added 'compose' in compose_command_property (#879) (769b7b6)
• core: allow setting docker command path for docker compose (#512) (63fcd52)
• core: Avoid hanging upon bad docker host connection (#742) (4ced198)
• core: bad rebase from #579 (#635) (4766e48)
• core: bring back dind tests (7337266)
• core: change with_command type to include list of strings (#789) (f7c29cb)
• core: create_label test (#771) (7517297)
• core: Determine docker socket for rootless docker (#779) (6817582)
• core: DinD issues #141, #329 (#368) (b10d916)
• core: env vars not being respected due to constructor call (#524) (4872ea5), closes #521
• core: Fix issues with doctests (#893) (2e4d80a)
• core: improper reading of .testcontainers.properties (#863) (350f246)
• core: Improve private registry support (tolerate not implemented fields in DOCKER_AUTH_CONFIG) (#647) (766c382)
• core: Improve typing for common container usage scenarios (#523) (d5b8553)
• core: make config editable to avoid monkeypatching.1 (#532) (3be6da3)
• core: make sure context manager exits (#876) (10089f6)
• core: Make TC_POOLING_INTERVAL/sleep_time a float (#839) (a072f3f)
• core: multiple container start invocations with custom labels (#769) (3e783a8)
• core: mypy (#810) (b816762)
• core: raise an exception when docker compose fails to start #258 (#485) (d61af38)
• core: recreate poetry lockfile with latest versions of libraries (#946) (9a97385)
• core: remove version from compose tests (#571) (38946d4)
• core: Reorganize core tests and improve (#693) (f1665f3)
• core: running testcontainer inside container (#714) (85a6666)
• core: Typing in auth (#691) (66726b6)
• core: Typing in config + utils (#692) (794a22e)
• core: Typing in docker_client (#702) (e8bf224)
• core: Typing in generic + network (#700) (2061912)
• core: Typing in version (#701) (9dc2a02)
• core: use auto_remove=True with reaper instance (#499) (274a400)
• core: Use WaitStrategy internally for wait_for function (#942) (e323317)
• core: wait in test core registry (#812) (b574c0e)
• core: waiting improvements + remove decorators in core (#894) (f93f379)
• cosmosdb: Add support for the CosmosDB Emulator (#579) (8045a80)
• dependencies: remove usage of sqlalchemy in DB extras. Add default wait timeout for wait_for_logs (#525) (fefb9d0)
• do not require consumer of library to state nonsupport for py4 (#912) (f608df9)
• docs: Update dependencies for docs (#900) (3f66784)
• docs: update the non-existent main.yml badge (#493) (1d10c1c)
• elasticsearch: Use wait strategy instead of deprecated decorator (#915) (c785ecd)
• Enable mypy in the CI (#842) (ef65bd1)
• failing tests for elasticsearch on machines with ARM CPU (#454) (701b23a)
• Fix the return type of DockerContainer.get_logs (#487) (cd72f68)
• flaky garbage collection resulting in testing errors (#423) (b535ea2)
• generic: Also catch URLError waiting for ServerContainer (#743) (24e354f)
• generic: Update the FastAPI install on genric module doctest samples (#686) (5216b02)
• go back to 4.0.1 (#465) (1ac8c24)
• google: add support for Datastore emulator (#508) (3d891a5)
• improve ollama docs, s/ollama_dir/ollama_home/g (#619) (27f2a6b)
• Improved Oracle DB module (#363) (6e6d8e3)
• inconsistent test runs for community modules (#497) (914f1e5)
• issue #889 by changing the annotated return type of waiting_for to Self. (#890) (fe941b1)
• just use the getLogger API and do not override logger settings (#836) (f467c84)
• k3s: add configuration parameter for disabling cgroup mount to avoid "unable to apply cgroup configuration" (#592) (8917772)
• kafka: add a flag to limit to first hostname for use with networks (#638) (0ce4fec), closes #637
• kafka: Add Kraft to Kafka containers (#611) (762d2a2)
• kafka: Add redpanda testcontainer module (#441) (451d278)
• kafka: wait_for_logs in kafka container to reduce lib requirement (#377) (909107b)
• keycloak: add realm imports (#565) (f761b98)
• keycloak: Add support for Keycloak version >=25 (#694) (62bd0de)
• keycloak: container should use dedicated API endpoints to determine container readiness (#490) (2e27225)
• keycloak: Fixed Keycloak testcontainer for latest version v26.1.0 (#766) (b1642e9)
• keycloak: realm import (#584) (111bd09)
• keycloak: tests on aarch64, use image from [jboss -> quay], change supported version [16+ -> 18+] (#480) (5758310)
• milvus healthcheck: use correct requests errors (#759) (78b137c)
• minio: minio client requires kwargs now (#933) (37f5902)
• minio: Use wait strategy instead of deprecated decorator (#899) (febccb7)
• missing typing-extensions dependency (#534) (ef86d15), closes #533
• modules: fix cosmosdb failure (#827) (dafcbed)
• modules: Mailpit Container (#625) (0b866ff)
• modules: Mailpit container base API URL helper method (#643) (df07586)
• modules: SFTP Server Container (#629) (2e7dbf1)
• modules: update chroma version (#826) (b7d41dd)
• mongodb: waiting for container to start (it was not waiting at all before?) (#461) (2c4f171)
• mongo: mongo start waiting forever for old mongo versions (#783) (1388612)
• move TESTCONTAINERS_HOST_OVERRIDE to config.py (#603) (2a5a190), closes #602
• mqtt: Add mqtt.MosquittoContainer (#568) (#599) (59cb6fc)
• mssql: use glob to find mssql-tools folder since it moves (#685) (4912725), closes #666
• mysql typo (#705) (85d6078), closes #689
• mysql: add dialect parameter instead of hardcoded mysql dialect (#739) (8d77bd3)
• mysql: Add seed support in MySQL (#552) (396079a)
• nats: add support for jetstream (#938) (49c9af8)
• nats: Client-Free(ish) NATS container (#462) (302c73d)
• network: Now able to use Network without context, and has labels to be automatically cleaned up (#627) (#630) (e93bc29)
• new: add a new Docker Registry test container (#389) (0f554fb)
• ollama: make device request a list (#799) (9497a45)
• on windows, DockerCompose.get_service_host returns an unusable "0.0.0.0" - adjust to 127.0.0.1 (#457) (2aa3d37)
• opensearch: add support for admin_password in >= 2.12 (#697) (935693e)
• pass doctests, s/doctest/doctests/, run them in gha, s/asyncpg/psycopg/ in doctest, fix keycloak flakiness: wait for first user (#505) (545240d)
• pass updated keyword args to Publisher/Subscriber client in google/pubsub #161 (#164) (8addc11)
• Pin MongoDB images and improve test coverage for maintained versions (#448) (b5c7a1b)
• postgres use psql instead of logs (#704) (4365754)
• postgres: doctest (#473) (c9c6f92)
• postgres: get_connection_url(driver=None) should return postgres://... (#588) (01d6c18), closes #587
• Qdrant module (#463) (e8876f4)
• rabbitmq readiness probe (#375) (71cb75b)
• rabbitmq: add vhost as parameter to RabbitMqContainer (#656) (fa2081a)
• rabbitmq: correct pika pypi reference (#817) (e90d308)
• read the docs build works again (#496) (dfd1781)
• readthedocs build - take 1 (#495) (b3b9901)
• redpanda: copy the startup script to a path that can be written … (#867) (e6b976d)
• registry: module typed (#811) (6b11268)
• release: prove that the release process updates the version (#444) (87b5873)
• remove accidentally added pip in dev dependencies (#516) (dee20a7)
• ryuk: Enable Ryuk test suite. Ryuk image 0.5.1 -> 0.7.0. Add RYUK_RECONNECTION_TIMEOUT env variable (#509) (472b2c2)
• scylla: scylla get cluster method (#778) (46913c1)
• security: Update track-modules job (#787) (f979525)
• selenium: add Arg/Options to api of selenium container (#654) (e02c1b3), closes #652
• test linting issue (427c9b8)
• tests for Kafka container running on ARM64 CPU (#536) (29b5179)
• tests: Missing artifacts (include-hidden-files) (#699) (8f1165d)
• tests: replace dind-test direct docker usage with sdk (#750) (ace2a7d)
• trino: Remove deprecated class and decorator from Trino container (#895) (bb646e9)
• try to fix release-please by setting a bootstrap sha (#472) (ca65a91)
• unclosed socket warning in db containers (#378) (cd90aa7)
• update test module import (#623) (16f6ca4)
• Update the copyright header for readthedocs (#341) (5bef18a)
• update wait_for_logs to not throw on 'created', and an optimization (#719) (271ca9a)
• url quote passwords (#549) (6c5d227)
• use connection mode override function in config (#775) (ab2a1ab), closes #774
• Vault health check (#734) (79434d6)
• vault: add support for HashiCorp Vault container (#366) (1326278)
• wait_for_logs can now fail early when the container stops (#682) (925329d)

Documentation

• Add a more advance usecase documentation for ServerContainer (#688) (2cf5a9f)
• contributing: add contribution and new-container guide (#460) (3519f4b)
• Documentation fix for ServerContainer (#671) (0303d47)
• Fixed typo in CONTRIBUTING.md (#767) (f0bb0f5)
• main: Private registry (#598) (9045c0a)
• missing compose html from old docs (#776) (d749fc6)
• Sphinx - Add title to each doc page (#443) (750e12a)
• Update private registry instructions (#604) (f5a019b)

This PR was generated with Release Please. See documentation.